home *** CD-ROM | disk | FTP | other *** search
/ Programmer Power Tools / Programmer Power Tools.iso / progjrn / pj_7_6.arc / WINDEV.ARC / WNTERM.DOC < prev    next >
Text File  |  1989-07-31  |  4KB  |  107 lines
  1.  
  2.  
  3.  
  4.                  WNTERM
  5.  
  6.         A Simple Windows Terminal Program
  7.  
  8.              William S. Hall
  9.              3665 Benton Street, #66
  10.               Santa Clara, CA 95051
  11.  
  12.  
  13.               Introduction
  14.  
  15.      WNTERM is a dumb terminal program written for Microsoft
  16. Windows.  The purpose of the program is educational and it is
  17. distributed with source code.  No attempt has been made to add
  18. features such as memory paging, clipboard data exchange, or smart
  19. terminal emulation.  The primary goal is to show how to use the
  20. Windows communications features and to illustrate subclassing and
  21. font enumeration.  However, the program functions quite
  22. adequately as a means for basic communication with another
  23. computer through the serial port.
  24.  
  25.      WNTERM has a useful option allowing you to choose a font
  26. which will provide the maximum number of visible lines on the
  27. screen.  One possible application is to use WNTERM as a debugging
  28. terminal.  See the sections below on selecting a small font and
  29. the caveats about maximum baud rates.
  30.  
  31.  
  32.             Program Operation
  33.  
  34.      To use the program, copy WNTERM.EXE to an appropriate
  35. directory and run it under Windows.  The program  first tries to
  36. open COM1.  If not successful, it tries COM2.  If this fails, the
  37. program exits.  if a port can be opened, the baud rate, parity,
  38. and word size will be set according to the COMx: strings in the
  39. [ports] section of win.ini.  You should modify these values (use
  40. the Control Panel) if to do so does not interfere with a serial
  41. printer setting.  Otherwise, you can set the desired parameters
  42. with the program's 'Communications' menu.
  43.  
  44.      When the window appears, the program will be ready to
  45. communicate with the port shown in the title bar.  You can switch
  46. between line and local operations by toggling the 'Line/Local'
  47. menu item.  At any time, you can clear the screen with the
  48. 'ClearScreen' menu choice.  If needed, Local Echo can be
  49. selected.  Scrolling can be started and stopped with the Scroll
  50. Lock key.
  51.  
  52.  
  53.  
  54.  
  55.  
  56.                Using a Small Font
  57.  
  58.      After the program has run for the first time, an entry is
  59. made in win.ini of the form:
  60.  
  61.     [Wnterm]
  62.     SmallFont=0
  63.  
  64. If you change 0 to 1, the program will search all Courier fonts
  65. installed on your system for the one with the smallest height. 
  66. If one is found with a height less than and of width less than or
  67. equal to that of the Windows system font, then the smaller font
  68. will be used.  In this way, it is possible to have more lines on
  69. the screen.  If you install COURA.FON (which is normally copied
  70. to your Windows directory only if you have a CGA, so you may have
  71. to retrieve it from the distribution disks), you can have as many
  72. as 73 lines on a VGA screen and 53 on the EGA.  If no small font
  73. is found, then the system font will be used.  You will then have
  74. a maximum of 29 lines on the VGA and 32 on the EGA.  (The EGA
  75. system font is only 10 pixels high, whereas on the VGA it is 15).
  76.  
  77.  
  78.            Flow Control and Baud Rates
  79.  
  80.      The program needs XON-XOFF on the host side for baud rates
  81. above 2400.  At 2400 baud or below, the performance on a 16 mHz.
  82. 386 machine is adequate for sustained operation without
  83. handshaking at full screen.  You may have to experiment with
  84. machines of lower performance to find the maximum usable baud
  85. rate with no flow control.  Generally this is of no concern
  86. unless the host is incapable of XON-XOFF as might be the case
  87. when WNTERM is being used as a debugging terminal.
  88.  
  89.  
  90.           Windows Communications Driver
  91.  
  92.      COMM.DRV in most versions of Windows 2.10 will not operate
  93. correctly with Xon-Xoff flow control.  A replacement is provided
  94. with this program.  You will have to reinstall Windows to use the
  95. new driver.  Begin by using Diskcopy to duplicate the diskette on
  96. which the old COMM.DRV file is located.  Replace COMM.DRV with
  97. the new version.  Now run Windows Setup with the modified
  98. diskettes.
  99.  
  100.  
  101.                Source Code
  102.  
  103.      The source code is enclosed on the disk.  If you know
  104. Windows programming, it should not be too difficult to read.  If
  105. you do not, watch Programmer's Journal for an article based on
  106. this program.
  107.